home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / postgres / postgre2.z / postgre2 / ref / unix / destroydb < prev    next >
Encoding:
Text File  |  1992-08-27  |  1.7 KB  |  78 lines
  1. .\" XXX standard disclaimer belongs here....
  2. .\" $Header: /private/postgres/ref/unix/RCS/destroydb,v 1.9 1992/07/14 05:54:17 ptong Exp $
  3. .SP DESTROYDB UNIX 6/14/90
  4. .XA 1 Destroydb
  5. .uh NAME
  6. .lp
  7. destroydb \*- destroy an existing database
  8. .uh SYNOPSIS
  9. .lp
  10. .(l
  11. \fBdestroydb\fR [\fB-p\fR port] [\fB-h\fR host] username
  12. .)l
  13. .uh DESCRIPTION
  14. .lp
  15. .b Destroydb
  16. removes all reference to an existing database named
  17. .i dbname.
  18. The directory containing this database and all associated files
  19. are removed.
  20. .lp
  21. To execute this command, the user must be the
  22. .A DBA
  23. for this database.
  24. After the database is destroyed, a \*(UU shell prompt will reappear;
  25. no confirmation message will be displayed.
  26. .lp
  27. .b Destroydb
  28. needs to connect to a running postmaster to accomplish
  29. its tasks.  If no postmaster is running then one must be started
  30. before destroydb is run.
  31. .lp
  32. .uh "COMMAND OPTIONS"
  33. .lp
  34. \fI-p port\fR indicates that destroydb should attempt to connect to a
  35. postmaster listening to the specified port.
  36. .lp
  37. \fI-h hostname\fR indicates that destroydb should attempt to connect to a
  38. postmaster running on the specified host machine.
  39. .sp
  40. .uh EXAMPLE
  41. .lp
  42. .ft C
  43. /* destroy the demo database */
  44. .ft
  45. .nf
  46. .ft C
  47. destroydb demo
  48. .ft
  49. .fi
  50. .lp
  51. .ft C
  52. /* destroy the demo database using the postmaster on host eden, port 1234 */
  53. .ft
  54. .nf
  55. .ft C
  56. destroydb -p 1234 -h eden demo
  57. .ft
  58. .fi
  59. .uh DIAGNOSTICS
  60. .sp
  61. .lp
  62. \fBError: Failed to connect to backend (host=\fIxxx\fB, port=\fIxxx\fB)\fR
  63. .lp
  64. destroydb could not attach to the postmaster on the specified host and
  65. port.  If you see this message, check that the postmaster is running on
  66. the proper host and that the proper port is specified.
  67. .sp
  68. .uh FILES
  69. .lp
  70. .ft C
  71. \&.../data/base/*
  72. .ft
  73. .uh "SEE ALSO"
  74. .lp
  75. createdb(unix),
  76. postmaster(unix),
  77. destroydb(commands).
  78.